home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #1 / Amiga Plus 1995 #1.iso / animationen / mainactor / docs / mainactor.doc < prev    next >
Text File  |  1994-12-13  |  28KB  |  844 lines
  1.  
  2. MainActor Documentation, 1993 Markus Moenig
  3. -------------------------------------------
  4.  
  5. Content
  6. -------
  7.  
  8.   Introduction
  9.  
  10.    1.1 Disclaimer
  11.    1.2 Credits
  12.    1.3 Introduction to MainActor
  13.    1.4 Features of MainActor
  14.  
  15.   The Menus
  16.  
  17.    2.1 The Project Menu
  18.    2.2 The Text Buffer Menu
  19.    2.3 The Miscellaneous Menu
  20.    2.4 The Arexx Menu
  21.    2.5 The Windows Menu
  22.  
  23.     The Windows
  24.  
  25.      3.1 The Project Windows
  26.      3.2 The Project Control Panel Window
  27.      3.3 The Project View Settings Window
  28.      3.4 The System Preferences  Window
  29.      3.5 The MainActor Preferences  Window
  30.  
  31. 1.1 Disclaimer
  32. --------------
  33.  
  34.  
  35.   MainActor is shareware. The program may be freely distributed and
  36.   copied, as long as the following conditions are fulfilled:
  37.  
  38.   -The sales price must not be higher than the cost of an (empty)
  39.    disk plus a nominal copying fee plus costs for shipping. The total
  40.    price must not be higher than 6 US$ or 10 DM.
  41.  
  42.   -All parts of the program and the documentation must be complete.
  43.    The distribution of single parts is not allowed.
  44.  
  45.   -MainActor or parts of it must not be sold in combination with
  46.    commercial software or as parts of it.
  47.  
  48.   -Program and documentation must not be changed in any ways.
  49.    The repacking of this distribution with different packers
  50.    is however allowed.
  51.  
  52.   -The author is not responsible for misuse, or damage caused
  53.    by MainActor.
  54.  
  55.   I ask everybody who uses MainActor on a regulary basis to register
  56.   by paying the shareware fee ($50).
  57.  
  58.   See the Registration.doc file for more info.
  59.  
  60.   NOTE THIS MANUAL ONLY COVERS THE ENGLISH VERSION, IF YOU RUN MAINACTOR
  61.   ON AN LOCALIZED SYSTEM, THE GADGET AND MENU NAMES MAY DIFFER.
  62.  
  63.  
  64. 1.2 Credits
  65. -----------
  66.  
  67.  
  68.   This package was developed by usage of the following products:
  69.  
  70.   -Dice, from Obvious Implementation Corp
  71.  
  72.   -Devpac 3.04, from HiSoft
  73.  
  74.   -WShell2.0 and Arexx, from Wishful Thinking Corp
  75.  
  76.   -TurboText from Oxxi
  77.  
  78.     -MultiTool II from Boris Jakubaschk
  79.     
  80.     and finally ToolManager from Stefan Becker.
  81.  
  82.   Thanks for producing high quality software for the best computer around.
  83.  
  84.   Thanks to all GAMMA and BETA testers, which are:
  85.  
  86.   Stefan Becker, Klaus Melchior, Boris Jakubaschk, Per Flodin and Joerg Gutzke.
  87.  
  88.   Special thanks to Sefan Becker for his Amiga knowledge, without
  89.   him this project would not have been become possible.
  90.  
  91.   Thanks to Norbert Bogenrieder for the icons.
  92.  
  93.  
  94. 1.3 Introduction to MainActor
  95. -----------------------------
  96.  
  97.  
  98.   MainActor is a modular animation package for the Amiga. There exist four
  99.   different kinds of modules
  100.  
  101.   1) Animation Loaders
  102.   2) Animation Savers
  103.   3) Picture Loaders
  104.   4) Picture Savers
  105.  
  106.   this can change in the future.
  107.  
  108.   You can handle up to five projects; every project can have an animation or
  109.   picture loader, as well as an animation or picture saver. This makes it
  110.   possible to convert everything in any ways, the number of
  111.   available modules can be easily upgraded.
  112.  
  113.   Look at the Modules.Doc for information and the capabilities of the
  114.   different modules included in this release.
  115.  
  116.  
  117. 1.4 Features of MainActor
  118. -------------------------
  119.  
  120.  
  121.   Here is a list of the general features of the modules and MainActor, note
  122.   that some specific features are only possible on specific module types.
  123.  
  124.   -Intelligent caching/tracking, MainActor can cache your animations and
  125.    picture lists, if you have not enough memory it will directly access
  126.    your data from any device. This makes it for example possible to
  127.    create/edit/play a 400MB animation on your 2MB Amiga.
  128.  
  129.   -If you run OS 3.0 or higher, you will get an extra speed bonus on
  130.    animations through the use of the new graphics routines.
  131.    For OS2.0/2.1 users there are specific routines in the modules, which
  132.    will give them the best playback speed possible on their system
  133.    (and my knowledge :)).
  134.  
  135.   -Under OS 3.0 you will get the extra features of showing pictures or
  136.    playing animations in a scrollable, resizable window on your MainActor
  137.    or Workbench screen. The colors will be properly adjusted to your screen
  138.    attributes.
  139.  
  140.   -The modules have play routines of their own, so it will be possible
  141.    to redirect the input/output of special modules to graphic cards or other
  142.    hardware.
  143.    
  144.   -The play routines support a timecode per frame option. A Sound Module
  145.    (per frame) option will be there in one of the next releases.
  146.  
  147.   -MainActor has a totally user reconfigureable GUI. The settings of your
  148.    sessions can be saved, this includes the size/position of windows
  149.    as well as the status of the projects.
  150.  
  151.   -MainActor has an arexx port, nearly all functions can be accessed through
  152.    it. You can for example scale or dither whole animations on the fly through
  153.    the use of an image processor, scripts are included.
  154.  
  155.   -MainActor lets you setup and save nearly everything concerning the
  156.    display mode for playing an animation or showing a picture.
  157.    For example you can set the X/Y offsets, the display mode ID
  158.    of your screen (view) and so on.
  159.  
  160.   -MainActor supports localization.  
  161.  
  162.  
  163. 2  The Menus
  164. ------------
  165.  
  166.   Many of MainActors functions can be accessed through the menus, some
  167.   function can only be accessed through them. When functions belong
  168.   to a certain window, there will be a pointer to the appropiate
  169.   section of the documentation.
  170.  
  171.  
  172. 2.1 The Project Menu
  173. --------------------
  174.  
  175.  
  176. "Open Project"
  177.  
  178.   will open a new project window. There are five possible
  179.   project windows; if all windows have already been opened, a 
  180.   requester will inform you about it. -> "Project Windows"
  181.  
  182.   The attributes of the project windows will be set, according to the
  183.   defaults selectable in the -> "MainActor Preferences Window".
  184.  
  185. "Project"
  186.  
  187.   consists of several submenu items, their functions
  188.   are identical to the gadgets of the -> "Project Control Panel Window"
  189.  
  190. "Open Prefs"
  191.  
  192.   will open an asl-requester which lets you choose an MainActor
  193.   Preferences file, saved with one of the two following menu items.
  194.  
  195.   When you have choosen a prefs file, the display AND all projects and
  196.   their contents will be closed, MainActor will then be reopend with
  197.   the settings of the preferences file.
  198.  
  199.   NOTE that you can also activate MainActor by simply clicking on the icons
  200.   of the prefs files.
  201.  
  202. "Save Prefs As ..."
  203.  
  204.   saves your current setup of MainActor; nearly everything will
  205.   be saved : the projects informations( All view settings,
  206.   the actual project name, the size and position of all windows, the settings
  207.   of the system preferences).
  208.  
  209.   An icon will be created for the preferences file.
  210.  
  211.   NOTE, you should save every setup used frequently !
  212.  
  213. "Save Prefs As Defaults"
  214.  
  215.   This will save your setup as the default preferences file, which will
  216.   be automatically loaded when you start MainActor.
  217.   The default preferences file is "MainActor:Prefs/Default_Prefs".
  218.   Replace the default by your most used setup.
  219.  
  220. "Iconify"
  221.  
  222.   MainActor will be terminated and the MainActor icon will be placed on your
  223.   workbench. If you want to reactivate MainActor, just click on the icon.
  224.  
  225. "About"
  226.  
  227.   Gives you some informations of the current version of MainActor.
  228.  
  229. "Quit"
  230.  
  231.   Will quit MainActor.
  232.  
  233.   NOTE, when you have projects loaded, they will be closed automatically.
  234.  
  235.  
  236. 2.2 The Text Buffer Menu
  237. ------------------------
  238.  
  239.  
  240.   MainActor uses the -> "Text Buffer Window" for presenting feedback to the
  241.   user.
  242.  
  243. "Print Buffer"
  244.  
  245.   Prints the informations stored in the Text Buffer Window.
  246.  
  247. "Save Buffer As ..."
  248.  
  249.   Let you choose a file, in which the contents of the Text Buffer Window
  250.   will be saved.
  251.  
  252. "Clear Buffer"
  253.  
  254.   Will clear the Text Buffer Window and its buffer.
  255.  
  256.  
  257. 2.3 The Miscellaneous Menu
  258. --------------------------
  259.  
  260.   The menu items of this menu will only be accessable when a
  261.   project is loaded in the source project. The "Set Timecode" Item
  262.   will only be activated if an animation project is loaded in the
  263.   Source.
  264.  
  265. "Select All"
  266.  
  267.   This item will select all items (==Frames/Pictures) in your source project.
  268.  
  269. "Select Range"
  270.  
  271.   A requester will pop up, just enter the start/stop frame for the range of
  272.   items to be selected.
  273.  
  274. "DeSelect All"
  275.  
  276.   This item will deselect all Items (==frames/pictures) in your source project.
  277.  
  278. "DeSelect Range"
  279.  
  280.   A requester will pop up, just enter the start/stop frame for the range of
  281.   items to be deselected.
  282.  
  283. "Set Timecode"
  284.  
  285.   Enter the timecode in the requester which you want to be applied to
  286.   all selected frames in the source project. Remember to hit return
  287.   after you typed a new value into the integer gadget.
  288.   The new timecode will be set immediately.
  289.   All timecodes are entered in 1/60 of a second, MainActor calculates
  290.   the right timecode for your vertical beam frequency itself.
  291.  
  292.  
  293. 2.4 The Arexx Menu
  294. ------------------
  295.  
  296.  
  297.   Look at the Arexx.Doc for more informations of MainActors Arexx capabilities.
  298.  
  299. "Start Arexx Script"
  300.  
  301.   Will let you choose an Arexx script, which will then be executed.
  302.  
  303.  
  304. 2.5 The Windows Menu
  305. --------------------
  306.  
  307.  
  308.   This menu will let you open/close the different MainActor windows
  309.   by simply selecting the desired Menu Item.
  310.  
  311.  
  312. 3 The Windows
  313. -------------
  314.  
  315.  
  316.   All windows, except the project windows, can be opened/closed
  317.   using the windows menu.
  318.  
  319.  
  320. 3.1 The Project Window
  321. ----------------------
  322.  
  323.  
  324.   A new Project Window will be opend by selecting the "Open new Project" Item
  325.   in the Project Menu.
  326.  
  327.   You can open up to five Project Windows, the number of your Project Window
  328.   will be displayed in the title bar, in front of the project name, like
  329.   "1: HAM8_Animation". If no project is loaded, the title is "Unused Project".
  330.  
  331.   If you have loaded a project, you can find further informations about it
  332.   in the screens title bar (when the Project Window is activated).
  333.   (CPF stands for Color per Frame, CPA for Color per Animation).
  334.     
  335.   The Project Windows are mainly controlled by the ->"Project Control Panel"
  336.   Window.
  337.  
  338.   The first Gadget is the
  339.  
  340. "Project Mode Gadget"
  341.  
  342.   Depending on your projects mode, it will be labeled "Source Project",
  343.   "Destination Project" or "DeActivated Project".
  344.  
  345.   -The Source Project
  346.  
  347.    You can only have one source project. This is the project on which all
  348.    actions from the -> "Project Control Panel" will be executed. The gadgets
  349.    of the Project Control Panel and the Project View Settings will be
  350.    setup, according to the source project.
  351.  
  352.   -The Destination Project
  353.  
  354.    This is the project into which all selected data from the source project
  355.    will be appended through the "Append" gadget of the Project View Settings
  356.    Window.
  357.  
  358.    There can only be one Destination Project.
  359.  
  360.   -The DeActivated Projects
  361.  
  362.    These projects are waiting to be switched into the source or destination
  363.    mode. There can be more than one DeActivated Project.
  364.  
  365.  
  366.   You can change the project mode by clicking on the Project Mode Gadget,
  367.   for example if you click on the source projects "Project Mode Gadget",
  368.   it will changed into the destination project and the former destination
  369.   project will changed into the source project.
  370.  
  371.   If you click on a DeActivated Projects "Project Mode Gadget", it will
  372.   change into the source project.
  373.  
  374.   If only one Project Window is open, you cannot change the "Project Mode
  375.   Gadget".
  376.  
  377.   NOTE that everytime you switch on the source project, the gadgets in the
  378.   "Project Control Panel" and the "Project View Settings" Window
  379.   will be adjusted to the settings of the new source project.
  380.  
  381. "Caching"
  382.  
  383.   This is a simple toggle gadget. If it is checked, it means that your
  384.   Project is cached or is going to be cached in Ram.
  385.  
  386.   If you have not enough Ram, you will have to disable it. That means that
  387.   for example animations will be directly played from your harddisk, which
  388.   will be much slower than playing them directly from Ram.
  389.  
  390.   Note that you can only toggle the status of the "Caching" gadget when
  391.   the project window is unused. As soon as you load a project, it will
  392.   become 'ghosted'.
  393.  
  394. "Select Load Module"
  395.  
  396.   When clicking on this Button Gadget, a requester will appear in which
  397.   you can select the loader module.
  398.  
  399.   The cycling gadget in the requester will let you switch between "Picture
  400.   Loaders" or "Animation Loaders".
  401.  
  402.   When hitting the "Load" Gadget in the "Project Control Panel" Window,
  403.   MainActor executes the animation/picture loader you have selected for
  404.   the source project.
  405.  
  406.   For further informations look at the "Load" gadget of the "Project Control
  407.   Panel".
  408.  
  409.   The name of the current loader module becomes visible in an text gadget directly
  410.   under the "Select Load Module" gadget. Next to the name is a small recessed
  411.   box with an "A" or "P" in it. They stand for "A"nimation or "P"icture loader.
  412.  
  413.   Note that the "Select Load Module" gadget will be ghosted as soon as you
  414.   load a project.
  415.  
  416. "Select Save Module"
  417.  
  418.   When clicking on this Button Gadget, a requester will appear in which
  419.   you can select the saver module.
  420.  
  421.   The cycling gadget in the requester will let you switch between "Picture
  422.   Savers" or "Animation Savers".
  423.  
  424.   When hitting the "Save" gadget in the "Project Control Panel" Window,
  425.   MainActor executes the animation/picture saver you have selected for
  426.   the source project.
  427.  
  428.   For further information look at the "Save" gadget of the "Project Control
  429.   Panel".
  430.  
  431.   The name of the current saver module you see in an text gadget directly
  432.   under the "Select Save Module" gadget. Next to the name is a small recessed
  433.   box with an "A" or "P" in it. They stand for "A"nimation or "P"icture saver.
  434.  
  435.   Note that the "Select Save Module" gadget will only be accessable when
  436.   a project is loaded.
  437.  
  438. "The Scrolling Frames/Picture List"
  439.  
  440.   This scroll gadget, will let you choose the frames or pictures you want to
  441.   execute a certain operation on.
  442.  
  443.   If you have an animation loader for this project window, the scroll list
  444.   will show you the numbered Frames of the Animation with their timecodes.
  445.  
  446.   If you have a picture Loader, the scroll list will show you the names of the
  447.   pictures you have loaded without their Path.
  448.  
  449.   Just (de)select the frame/picture by clicking on its text. The scroll list
  450.   will automatically scroll up/down if you select an item at the border.
  451.  
  452.   At the ->"Main Actor Preferences" Window you can select, how many items
  453.   shall be displayed in the scroll list. You can also select a special
  454.   Font for it. (The default is Topaz 8 for the font and 8 for the number
  455.   of items who shall be visible).
  456.  
  457.  
  458. 3.2 The Project Control Panel Window
  459. ------------------------------------
  460.  
  461.  
  462.   This window executes its functions on the actual Source Project Window.
  463.  
  464. "Load"
  465.  
  466.   If you have an animation loader selected for the source project, an
  467.   qequester will appear in which you have to select an animation of
  468.   the appropiate type.
  469.  
  470.   If you have an picture loader selected, the first requester will
  471.   ask you about the first Picture, after selecting this
  472.   picture the second qequester will ask you about the last picture.
  473.   MainActor will now alphabetically sort the pictures and load them.
  474.   For example, if you have a picture list:
  475.   Amiga_Pic.00001
  476.   Amiga_Pic.00002
  477.   .
  478.   .
  479.   Amiga_Pic.00155
  480.  
  481.   and select Amiga_Pic.00055 in the first requester and Amiga_Pic.00100 in the
  482.   next, all pictures from Amiga_Pic.00055 to Amiga_Pic.00100 will be loaded.
  483.   The second requester is optional, that means you can abort it by clicking
  484.   on "Cancel" if you just want to load one picture.
  485.  
  486.   The "Load" gadget is only available if you have not loaded a project into
  487.   the source project yet.
  488.  
  489. "Unload"
  490.  
  491.   Is the gadget directly under the "Load" gadget. It will unload the current
  492.   project of the source project.
  493.   It is only available when you have loaded a project in the source project.
  494.  
  495. "Play"
  496.  
  497.   Is next to the "Load" gadget. It is only available when you have loaded
  498.   an animation project in the source project.
  499.  
  500.   If you play your animation on a screen, there are two routines available.
  501.   MainActor checks automatically if you run an OS Version lower than
  502.   OS 3.0 and will play it the old fashioned way. If you have OS 3.0 or
  503.   higher you will profit from the new double buffering routines.
  504.  
  505.   The following keys can be used to control the playing of the animation:
  506.     
  507.   ESCAPE OR A MOUSEBUTTON will abort playing the animation
  508.   
  509.   SPACE will stop playing the animation. While the animation is stopped
  510.   you can use the TAB key to flip to the next frame.
  511.   
  512.   RETURN will enable the timecodes you see in the scroll list of the
  513.   source project and which you can change (These timecodes are default).
  514.  
  515.   The cursor keys scroll the display, the offset changes will be shown in
  516.   the "Project View Settings Window".
  517.   
  518.   The function keys are used to set the frame rate (and override the defaults,
  519.   you can reactivate them by pressing RETURN).
  520.   
  521.   Funtion Key                            Framerate
  522.   
  523.   F1                                     1  /60 Second
  524.   F2                                     2  /60 Second
  525.   F3                                     3  /60 Second
  526.   F4                                     4  /60 Second
  527.   F5                                     5  /60 Second
  528.   F6                                     10 /60 Second
  529.   F7                                     20 /60 Second
  530.   F8                                     40 /60 Second
  531.   F9                                     60 /60 Second
  532.   F10                                    120/60 Second
  533.  
  534.   If you have activated the "Frame Info" option in the ->"View Settings
  535.   Control Window", you can cycle the color of the info text using
  536.   the buttons "N" and "M" up and down.
  537.  
  538.   Note that the animation will be played according to the settings of
  539.   the ->"Project View Settings" Window.
  540.  
  541. "Show"
  542.  
  543.   Is the gadget under "Play". It will display all the frames/pictures you have
  544.   selected in the source projects scroll list.
  545.   This gadget is available for both animation and picture projects.
  546.  
  547.   The following keys can be used to control the showing of the pictures:
  548.  
  549.   ESCAPE OR A MOUSEBUTTON will abort showing the pictures.
  550.   
  551.   SPACE  will show the next pictures you have selected
  552.   
  553.   The cursor keys scroll the display, the offset changes will be shown in
  554.   the "Project View Settings" Window.
  555.  
  556.   Note that the frames/pictures will be shown according to the settings of
  557.   the ->"Project View Settings" Window.
  558.  
  559. "Save"
  560.  
  561.   Is the gadget next to "Play".
  562.  
  563.   If you have an animation saver activated in your source project, it will
  564.   ask you about the name of the new animation. Then it will build up the new
  565.   animation in the appropriate animation Format. It will only save the
  566.   frames you have SELECTED in the source projects scroll list. If you
  567.   just want to convert or resave the animation, you have to select all
  568.   the frames in the scroll list.
  569.  
  570.   If you have a picture saver activated in your source project, a requester
  571.   will appear in which you have to select the directory and the base name
  572.   of the Pictures.
  573.  
  574.   Example, you have activated an animation loader and a picture saver
  575.   and loaded an animation. The animation is called "Example_Anim". Now
  576.   you select the first ten frames of the animation and click on the
  577.   "Save" gadget. In the requester you type "Ram:" for the Directory and
  578.   "Example_Pics" for the Base Name.
  579.   The ten pictures will then be saved as
  580.   Ram:Example_Pics.00001
  581.   Ram:Example_Pics.00002
  582.   .
  583.   .
  584.   Ram:Example_Pics.00010
  585.  
  586.   This is also valid if you have a picture loader and a picture saver.
  587.  
  588.   If you have a picture loader and an animation saver, some more
  589.   gadgets will appear and ask you for some specific attributes
  590.   of the new animation: "Palette per Picture" and "Looping Animation".
  591.   If you have an animation loader and saver the saver module
  592.   will only ask, if you want to have a looping animation, the color
  593.   per frame setting will be set according to the source animation.
  594.   (You could change this by executing the "Save" function through
  595.   an arexx script).
  596.   
  597.   The following combinations are possible:
  598.  
  599.     Animation Loader and Animation Saver
  600.     Animation Loader and Picture Saver
  601.     Picture Loader and Animation Saver
  602.     Picture Loader and Picture Saver
  603.  
  604.   In this way, you can easily convert any picture/animation format into any
  605.   picture/animation format.
  606.  
  607. "Append"
  608.  
  609.   You can append the frames/pictures you have selected in the source project
  610.   to the destination project. The destination project has to be an animation
  611.   project.
  612.  
  613.   NOTE, the source projects animation saver has to belong to the
  614.   destinations loader module. (For Example the IFF-Anim5 loader and saver).
  615.   The destination project must NOT to be cached.
  616.  
  617.   Some Animation Types have to fulfill some other attributes, for example
  618.   the Anim5 format can only append to non-looping animations.
  619.     When you want to append frames to a loop Anim5 animation, just resave it
  620.     and select NO in the loop animation requester, then append the frames.
  621.  
  622.     If you want to add a loop to a non-looping animation, just append
  623.     two pictures which are identical to the first two, then reload the
  624.     animation.
  625.     
  626.   Look at the Modules.DOC information about the specific attributes of
  627.   the modules.
  628.  
  629.  
  630. 3.3 The Project View Settings Window
  631. ------------------------------------
  632.  
  633.  
  634.   With the "View Settings Window" you can setup the "Show Pictures" / "Play
  635.   Animation" output; it can be set for every project, its content
  636.   will be saved when saving the preferences.
  637.   
  638. "Frame Info"
  639.  
  640.   This switch (when activated) will give you informations about the 
  641.   current frame while playing animations. 
  642.   If playing on a screen you will see the info on the top right edge
  643.   of the screen. 
  644.   When you see no info text, use the "M" and "N" keys while playing
  645.   to cycle the color of the info text up and down
  646.   
  647.   When playing in a window, the windows title text will display the
  648.   infos for the current frame when "Frame Info" is enabled.
  649.  
  650. "Display Mode"
  651.  
  652.   This cycle gadget will let you choose between the screen and window
  653.   mode. In the screen Mode the animation/pictures will be shown on
  654.   a screen (view) of its own.
  655.  
  656.   In the window mode the animation/pictures will be shown in
  657.   a resizeable, scrollable window on your MainActor screen.
  658.   THIS OPTION IS ONLY AVAILABLE ON SYSTEMS RUNNING OS3.0+.
  659.   Note, the more colors the MainActor screen can display 
  660.   (->"System Preferences Window"), the better is the dithering of
  661.   your frame/picture. If you show a 256 color picture on a 4 Color
  662.   screen, you will be disappointed by the result.
  663.     The timecodes of the animation will be ignored, the animation
  664.     will be displayed as fast as possible.
  665.   
  666. "Select Display"
  667.  
  668.   You can choose the resolution/view mode of your animation/picture
  669.   with this gadget (makes only sense in the screen mode).
  670.   Note, this will override the old value, if you resave the animation/
  671.   pictures, the new value will be saved.
  672.   
  673. "X/Y Offsets"
  674.  
  675.   With these two integer gadgets, you can select the offsets for
  676.   showing animations/pictures (again, this makes only sense in the
  677.   screen mode). If you scroll a frame (while playing an animation or
  678.   showing a picture), the values of the gadgets will immediately be set
  679.   up to the new values.
  680.  
  681.  
  682. 3.4 The System Preferences Window
  683. ---------------------------------
  684.  
  685.  
  686.   These window will handle everything concerning the outer appearance
  687.   of MainActor.
  688.   
  689. "Select Font"
  690.  
  691.   Choose your font for MainActor. This font will then be used for
  692.   all windows, gadgets, menus. Only the list items of the
  693.   project windows will be displayed in a different font, you can select
  694.   it in the ->"MainActor Preferences Window".
  695.   
  696.   The actual font and its size are displayed beneath the gadget.
  697.   
  698.   The "Select Font" gadget is not activated when you clone the workbench
  699.   screen (->"Screen Size").
  700.   
  701. "Select Display"
  702.  
  703.   ONLY AVAILABLE AT OS 2.1 +
  704.   
  705.   Choose your display mode for your MainActor screen. The current display
  706.   mode is displayed beneath the gadget.
  707.   
  708.   This gadget is only activated when
  709.   
  710.   a) MainActor has a screen of its own
  711.    
  712.   and
  713.   
  714.   b) you dont clone the workbench screen (->"Screen Size").
  715.   
  716. "Use own Screen"
  717.  
  718.   If enabled, MainActor uses a screen of its own, if not, MainActor
  719.   will use the workbench screen.
  720.   
  721. "SHANGHAI Windows"
  722.  
  723.   If enabled, MainActor uses the SHANGHAI public screen mode, that means
  724.   that for example shell windows will automatically pop up on the MainActor
  725.   screen.
  726.   
  727.   This gadget is only activated when you run MainActor on a screen of its
  728.   own.
  729.   
  730. "Screen Size"
  731.  
  732.   You can choose MainActors screen size and its overscan mode with
  733.   this cycle gadget. The screen size of the current mode is displayed
  734.   in the two integer gadgets to the right of the "Screen Size" gadget.
  735.   The screen size depends on the screen mode you selected with the
  736.   "Select Display" gadget.
  737.   
  738.   "WorkBench"
  739.   
  740.    Clones the workbench screen properties (screen size, overscan mode, display
  741.    mode, font).
  742.    
  743.   "Custom"
  744.   
  745.    Enter MainActors screen size in the two integer gadgets to the right.
  746.    
  747.   "Standard"
  748.    
  749.    Use the standard screen size, without overscan ( for Example 640 * 512)
  750.    in Pal: HighRes Interlace).
  751.    
  752.   "Text Overscan"
  753.    
  754.    The normal overscan mode the workbench uses.
  755.     
  756.   "Video Overcan"
  757.    
  758.    Tries to open as big a screen as possible. Flickers on normal displays
  759.    at the right border.
  760.     
  761.   "Max Overscan"
  762.    
  763.    Slightly smaller than the "Video Overscan" mode, but as useless on
  764.    normal displays due to its flicker.
  765.    
  766.    
  767.   This gadget is only available when you have enabled the "Use own Screen"
  768.   gadget.
  769.   
  770. "Palette Size"
  771.  
  772.   Select the colors of your palette with this gadget. The value left
  773.   to the slider gadget shows the current colors available on your
  774.   MainActor screen.
  775.   
  776.   This gadget only makes sense if you display pictures or play animations
  777.   in the window mode. More colors == better dithering of your frames/
  778.   pictures. (the window mode is only available under OS 3.0 +).
  779.   
  780.   This gadget is only activated when
  781.   
  782.   a) MainActor has a screen of its own
  783.    
  784.   and
  785.   
  786.   b) you dont clone the workbench screen (->"Screen Size").
  787.  
  788. "Use System Preferences"
  789.  
  790.   If you want to activate the changes you have made to your display,
  791.   just click on this gadget.
  792.  
  793.  
  794. 3.5 The MainActor Preferences Window
  795. ------------------------------------
  796.  
  797.  
  798.   This window lets you choose/enter some special MainActor attributes.
  799.   
  800.  
  801. "Select Default Load Module"
  802.  
  803.   Lets you choose the default load module. Everytime you open
  804.   a new project window, the default load module will be the one
  805.   choosen for this new projects load module.
  806.  
  807. "Select Default Save Module"
  808.  
  809.   Lets you choose the default save module. Everytime you open
  810.   a new project window, the default save module will be the one
  811.   choosen for this new projects save module.
  812.  
  813. "Select List Item Font"
  814.  
  815.   Choose the font for your list items in your project windows,
  816.   this font must have a fixed with, the current font and its
  817.   size are displayed to the right of the gadget, (the default
  818.   is topaz.font 8).
  819.  
  820. "Number of List Items"
  821.  
  822.   You can enter how many list items will be displayed in the
  823.   project windows with this integer gadget.
  824.   
  825. "Use MainActor Preferences"
  826.  
  827.   When activated will enable the changes made to the MainActor
  828.   preferences.
  829.  
  830.  
  831. 3.6 The Text Buffer Window
  832. --------------------------
  833.  
  834.  
  835.   This window shows and buffers messages for feedback of the user.
  836.   If the window is activated, you can use the cursor up/down
  837.   keys to scroll the text one line up/down. 
  838.   Control+cursor up/down will move to the start/end of the buffer.
  839.  
  840.   You can also use the scrollbar to scroll through the buffer.
  841.   
  842.   Look at the "Text Buffer Menu" for more functions concerning
  843.   the text buffer.
  844.